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INTRODUCTION 

This supplement documents the actual structure and logic of the 
ProDOS system at nearly a byte by byte level. It is intended to aid 
experienced programmers in designing customized interfaces to 
ProDOS, and to provide implicit documentation of ProDOS's 
functions. Less advanced assembly language programmers may find 
this supplement useful in learning about how an operating system 
works. Providing this information does not constitute an 
endorsement by the authors of indiscriminant modification of the 
ProDOS components. Whenever possible, standardized interfaces to 
ProDOS should be used to avoid the uncontrolled modifications which 
were made to DOS 3.3. 

External system programs and utilities such as the FILER and 
CONVERT are not covered here. 

The information provided here is for two releases of the ProDOS 
operating system — Version 1.0.1 and Version 1.0.2. Because these 
versions are so similar, we have included both in the same 
supplement. Version 1.0.1 is first presented in its complete form. 
Then Version 1.0.2 is presented by pointing out and documenting 
those areas that are different from Version 1.0.1. 

As new releases of ProDOS become available, additional supplements 
to Beneath Apple ProDOS will be prepared. To order supplements for 
other versions of ProDOS, fill out the order form on page 125 of 
this supplement. Ordering instructions can be found on page 124. 
When ordering a new supplement, be sure to specify the version of 
ProDOS you want the new supplement for. 

UNDERSTANDING THE LISTINGS 

The listings which follow describe the major ProDOS components in 
great detail. Each module is presented separately and consists of 
a section defining external addresses referenced by the program 
(such as zero page usage, I/O select addresses, and global page 
fields) followed by a section describing the instructions and data 
in the module. Divisions between major sections and subroutines 
are indicated with a row of asterisks (*) and additional comments. 

Each detail line gives the address of the instruction or data field 
being described, followed by comments. Within the comments, the 
following notation is used to indicate references by instructions: 

(address) A store or load reference to a memory or I/O 

location. 
>>address A branch or jump to an address. 

<address> A call to a subroutine at the indicated address. 
— >address A pointer to an address. 

Page titles give the address of the next instruction or data area 
in the module to be described. These may be used to quickly locate 
a particular area within the component. 
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ProDOS VERSION 1.0.2 

In March, 1984, Apple began shipping Version 1.0.2 of ProDOS along 
with the Apple lie. Version 1.0.2 is also the base for some of 
Apple's own software, such as AppleWorks. The differences between 
this version and its predecessor. Version 1.0.1, are minor. Except 
for the specific areas mentioned below, the description of Version 
1.0.1 in this Supplement may be used for Version 1.0.2. 

ProDOS Loader 

Version 1.0.2 is identical to Version 1.0.1. 
ProDOS Relocator 

Replace the comments at the following addresses: 

20A2: YES, QUIT VECTOR — >$EEDB 

21B8: LEN = $1EDA 

21C1: TO = $AF71 

21C5: FRM = $AF71 

249A: 'PRODOS 1.0.2 15-FEB-84' 

All other addresses and comments remain the same as Version 1.0.1. 

ProDOS MLI (Kernel) 

Replace the comments at the following addresses: 

D19A: Indicate error type 2 
DE6D: Stomp on $F300+$5E 

At $E948, 12 bytes are added. This causes all addresses greater 
than $E947 and all references to those addresses to be increased by 
$0C. For example, all references to $E948 in Version 1.0.1 become 
$E954 in Version 1.0.2. The 12-byte insertion is commented as 
follows : 

E948: Flush file; update directory <E71C> 

E94B: No error? >>E954 

E94D: Error, return error code 

ProDOS System Global Page 

Version 1.0.2 is identical to Version 1.0.1. 
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ProDOS Quit Code 

version 1.0.2 is identical to Version 1.0.1. There is di-fferent 
data due to different uninitialized variables in a data area at the 
end of the Quit Code section, but this has no effect on the 
operation of the software. 

ProDOS Disk II Device Driver 

Minor changes to the beginning of the Disk II Device Driver caused 
the area from $F800 to $F8F3 to change and added a routine at the 
end of the Version 1.0.1 code ($FEBE to $FED1) . These two areas 
are described on the following pages. The rest of the Disk II 
Device Driver is identical to Version 1.0.1. 

ProDOS IRQ Handler 

Version 1.0.2 is identical to Version 1.0.1. 

ProDOS BI Relocator 

Version 1.0.2 is identical to Version 1.0.1. 

ProDOS BASIC Interpreter (BI) 

Version 1.0.2 is identical to Version 1.0.1. 

ProDOS BI Global Page 

version 1.0.2 is identical to Version 1.0.1. 
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ERRATA TO BENEATH APPLE PRODOS (1st Printing, 1984) 

Please make the following corrections to your copy of Beneath 
Apple ProDOS: 



Page 3-16: 

In the first paragraph starting on the page, the sentence 
should read "The data is dealt with in larger pieces (512 
bytes vs. 256 bytes) ", not 512K vs. 256K. 

Page 6-64: 

The code for "GIVEN A PAGE NUMBER, SEE IF IT IS FREE" is 
incorrect. Replace it with: 



BITMAP 


EQU 


$BF58 




LDA 


#PAGE 




JSR 


LOCATE 




AND 


BITMAP, Y 




, BNE 


INUSE 




TXA 






ORA 


BITMAP, Y 




STA 

• • • 


BITMAP, Y 


LOCATE 


PHA 






AND 


#07 




TAY 






LDX 


BITMASK,Y 




PLA 






LSR 


A 




LSR 


A 




LSR 


A 




TAY 






TXA 






RTS 





SEE PAGE 8-6 

GET PAGE NUMBER (MSB OF ADDR) 

LOCATE ITS BIT IN BITMAP 

IS IT ALLOCATED? 

YES, CAN'T TOUCH IT 

PUT BIT PATTERN IN ACCUM 

MARK THIS PAGE AS IN USE 

UPDATE MAP 

WE'VE GOT IT NOW 

SAVE PAGE NUMBER 

ISOLATE BIT POSITION 

THIS IS INDEX INTO MASK TABLE 

PUT PROPER BIT PATTERN IN X 

RESTORE PAGE NUMBER 

DIVIDE PAGE BY 8 



Y-REG IS OFFSET INTO BITMAP 
PUT BIT PATTERN IN ACCUM 
DONE 



BITMASK DFB $80 , $40 , $20 , $10 
DFB $08, $04, $02, $01 



BIT MASK PATTERNS 
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Page 7-26; 



Modifying the ProDOS Disk II device driver to allow 320 
blocks instead of the normal 280. The fourth command line 
should read: 

5200:40 



Modifying FILER to format 40 tracks instead of 35. 
command line should read: 

4244:40 



The fourth 



Page 8-6: 

Under "Device Information", make the following changes: 
BF10-BF11 DEVADR01 Slot reserved. 

• • • 

BF26-BF27 DEVADR32 /RAM device driver address 

(need extra 64K) . 

Page 8-7: 

The wrong bit is indicated as the "expansion bit" in the 
MACHID byte. The first eight rows of that description 



should 




read 




00. 




0... 


II 


01. 




0.. 


11 + 


10. 




0... 


lie 


11. 




0.. 


III emulation 


00. 




1... 


Future expansion 


01. 




1.. 


Future expansion 


10. 




1... 


lie 


11. 




1.. 


Future expansion 


Page B-8: 









In the last paragraph, the sentence should read "A second 
way to use an interpreted language..." (not a compiled 
language) . 



Page D-l: 



In the second paragraph, the sentence should read "Versions 
of the Disk Drive Controller Unit are now used..." (not 
based) . 
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Reference Card, Panel 4 

Under "SYSTEM GLOBAL PAGE FORMAT", replace the lines 
beginning BF05 and BF06 with the following two lines; 



BF06 Jump to Date/Time Address 
(or RTS if no clock) 



The description of BF10-11 should be changed to: 
BF10-11 Slot reserved 

The description of BF26-27 should be changed to: 
BF26-27 /RAM 



Under the "MACHINE IDENTIFICATION BYTE", the second column 
of numbers should read: 



0.. 
0. . 
0.. 
0.. 
1.. 
1.. 
1.. 
1.. 



Reference Card, Panel 9 

The last entry for "MLI ERROR CODES" should be: 

$5A Bad vol. bit map 
(not $58) . 



ORDERING FUTURE SUPPLEMENTS 

New supplements will be published to reflect the changes 
made as ProDOS is updated. To order an updated supplement, mail 
the coupon on the next page directly to Quality Software (at the 
address on the coupon) , along with a payment of $10.00 plus 
shipping and handling charges.* Your payment can be a check or 
bank draft in US dollars, or your VISA or MASTERCARD number and 
expiration date. California residents must add the appropriate 
sales tax (6 or 6.5%). No phone orders or CODs will be accepted. 

footnote: 

* SHIPPING & HANDLING CHARGES 

United States, Canada, and Mexico $ 2.50 

All other countries (insured air mail) $10.00 



